home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu374.dms / pu374.adf / WBVerlauf / WBVerlauf.doc < prev    next >
Text File  |  1992-12-07  |  3KB  |  84 lines
  1. WBVerlauf                                                           WBVerlauf
  2.  
  3.    NAME
  4.     WBVerlauf - Create background copper list on the Workbench screen
  5.  
  6.    SYNOPSIS
  7.     WBVerlauf Startcolor,Endcolor,ColorNumber/N,Step/N,Info/S
  8.  
  9.     The AGA chipset and Kickstart 3.0 are required.
  10.     All options are available from icon tooltypes or as command line
  11.     arguments.
  12.  
  13.    DESCRIPTION
  14.     WBVerlauf lets you create nice color effects for a selectable
  15.     pen color number on the Workbench screen, using the whole
  16.     16 million color range of the AGA chips.
  17.     It works in Workbench and shell environments, and can be put in the
  18.     WBStartup drawer.
  19.     You specify the color of the first and the last line of the screen,
  20.     and WBVerlauf will make a smooth color change by setting a new
  21.     color value on every scanline.
  22.     If started from a shell, you can hit Ctrl-C or use the "Break"
  23.     command to quit. If started from Workbench, double-clicking the
  24.     program icon again forces the running copy to self-terminate.
  25.  
  26.     Example: I have an 8 color Workbench, and I set the Workbench's
  27.              background color to color 4 (using the WBPattern prefs
  28.              editor). Then I set the COLORNUMBER tooltype to 4, so
  29.              only the Workbench's color gets changed by WBVerlauf.
  30.              This looks very nice (the icon is designed for this case).
  31.  
  32.    INPUTS
  33.     STARTCOLOR    - A six digit hexadecimal number specifying the
  34.               color of the first line of the screen. The first
  35.               two digits select the red level, the next two
  36.               digits the green and the last two digits the blue
  37.               level. So a startcolor of 0xF765E3 would give you
  38.               a nice pink (0xF7 for red, 0x65 for green and
  39.               0xE3 for blue; 00 is dark and FF is bright).
  40.  
  41.     ENDCOLOR    - A six digit hexadecimal number specifying the
  42.               color of the last line of the screen.
  43.  
  44.     COLORNUMBER/N    - Pen number of the color to change. A value of
  45.               0 means background color, 1 is normally the
  46.               text color, 3 is for window borders, etc.
  47.               Must be in the range of 0 to 255.
  48.  
  49.     STEP/N        - Number of lines between color changes. Defaults
  50.               to 1. If you have a slow processor, you may wish
  51.               to set this to a higher value, so the screens
  52.               will scroll faster.
  53.  
  54.     INFO/S        - Display a short info message and return to shell
  55.  
  56.    WARNING
  57.     This program makes use of undocumented hardware components of the
  58.     AGA chips, and is not programmed according to Commodore rules.
  59.     It will not work with future hardware or software versions.
  60.     You must NOT use this code in professional applications.
  61.  
  62.    BUGS
  63.     Tell me about any you find!
  64.  
  65.    AUTHOR
  66.     Christian A. Weber
  67.  
  68.     Internet:    weber@amiga.physik.unizh.ch
  69.     UUCP:        chris@mighty.adsp.sub.org
  70.     Snail mail:  Bruggerweg 2, CH-8037 Zürich, Switzerland.
  71.  
  72.    RELEASE
  73.     30-Nov-92    V1.4    Initial release
  74.     07-Dec-92    V1.5    Bug fixes:
  75.                 - Horizontal mouse pointer resolution change
  76.                   works correctly (with a slight delay..)
  77.                 - Colornumbers above 32 work correctly now
  78.  
  79.    LEGAL STUFF
  80.     Copyright © 1992 by Christian A. Weber.
  81.     This program may be distributed for non-profit purpose only.
  82.     No Warranty. Use at your own risk.
  83.  
  84.